<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
	<title>Kepler: The Lua Web Development Platform</title>
    <link rel="stylesheet" href="http://www.keplerproject.org/doc.css" type="text/css"/>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
</head>

<body>

<div id="container">

<div id="product">
	<div id="product_logo">
        <a href="http://www.keplerproject.org"><img alt="Kepler" src="kepler.png"/></a>
    </div>
	<div id="product_name"><big><strong>Kepler</strong></big></div>
	<div id="product_description">The Lua Web Development Platform</div>
</div> <!-- id="product" -->

<div id="main">
	
<div id="navigation">
<h1>Kepler</h1>
	<ul>
		<li><a href="index.html">Home</a>
			<ul>
				<li><a href="index.html#overview">Overview</a></li>
				<li><a href="index.html#status">Status</a></li>
				<li><a href="index.html#download">Download</a></li>
				<li><a href="index.html#history">History</a></li>
				<li><a href="index.html#credits">Credits</a></li>
				<li><a href="index.html#contact">Contact us</a></li>
			</ul>
		</li>
		<li><a href="install.html">Installation</a>
            <ul>
                <li><a href="install.unix.html">Unix/OSX</a></li>
                <li><strong>Windows</strong>
                    <ul>
                        <li><a href="install.windows.html#installer">Installer</a></li>
                        <li><a href="install.windows.html#directories">Directories</a></li>
                        <li><a href="install.windows.html#dependencies">Dependencies</a></li>
                        <li><a href="install.windows.iis.html">IIS</a></li>
                        <li><a href="install.windows.apache2.html">Apache 2</a></li>
                        <li><a href="install.windows.xavante.html">Xavante</a></li>
                    </ul>
                </li>
            </ul>
        </li>
        <li><a href="manual.html">Manual</a>
			<ul>
				<li><a href="manual.html#introduction">Introduction</a></li>
				<li><a href="manual.html#configuration">Configuration</a></li>
			</ul>
		</li>
		<li><a href="reference.html">Reference</a></li>
		<li><a href="examples.html">Examples</a></li>
        <li><a href="http://luaforge.net/projects/kepler/">Project</a>
            <ul>
                <li><a href="bugtracker.html">Bug Trackers</a></li>
                <li><a href="http://luaforge.net/scm/?group_id=104">CVS</a></li>
            </ul>
        </li>
		<li><a href="license.html">License</a></li>
	</ul>
</div> <!-- id="navigation" -->

<div id="content">

<h2><a name="installer"></a>Windows Installer</h2>

<p>The Kepler Windows installer can be found at its
<a href="http://luaforge.net/projects/kepler/files">LuaForge</a> page. The
installer is a Windows executable that allows the selection of the target directory
for Kepler (refered here as the <code>&lt;<em>Kepler Home</em>&gt;</code> directory) and the desired modules to be
installed.</p>

<p>Some of the modules are mandatory, but you can choose which database drivers
you want. Keep in mind that Kepler needs at least one database driver to be able
to use <a href="http://www.keplerproject.org/luasql/">LuaSQL</a>.</p>

<h2><a name="directories"></a>Directories</h2>

<p>After the installation is complete, the default Windows directory structure
for Kepler should be:</p>

<pre class="example">
&lt;<em>Kepler Home</em>&gt;
    /apps
        /cgilua           -- CGILua applications
    /bin                  -- Executables, libraries and launchers
    /conf                 -- Configuration files
    /log                  -- Xavante logs
    /lua                  -- Lua modules
    /tmp                  -- Temp files
    /web                  -- Xavante Web documents base directory
</pre>

<h2>Web Server configuration</h2>

<p>Once Kepler is installed you need to configure your Web Server so it
can use Kepler. This is highly dependent on the Web Server and the launching
method. For more details please check:</p>

<ul>
    <li><a href="install.windows.iis.html">IIS</a> (ISAPI, FastCGI, CGI)</li>
    <li><a href="install.windows.apache2.html">Apache 2</a> (mod_lua, FastCGI, CGI)</li>
    <li><a href="install.windows.xavante.html">Xavante</a> (native)</li>
</ul>

<h2><a name="dependencies"></a>Libraries Dependencies</h2>

<p>There are a number of external libraries that Kepler components depend on.
The most important is the Lua library itself: <code>lua5.1.dll</code>. Other 
external libraries are required by specific components, i.e.
<code>libexpat.dll</code> is required by LuaExpat.</p>

<p>Some external libraries may have to be copied to the diretory where the
CGILua launcher will be executed and that depends on the chosen launcher.
Another option is to add the value of <code>&lt;<em>Kepler Home</em>&gt;/bin</code>
to the system <code>PATH</code> environment variable so Windows can find the
dependencies.</p>

<p>The external libraries are:</p>

<pre class="example">
&lt;<em>Kepler Home</em>&gt;
    /bin
        cgilua_isapi.dll   -- required by the ISAPI launcher
        libexpat.dll       -- required by LuaExpat
        libfcgi.dll        -- required by the FastCGI launcher
        lua5.1.dll         -- required by all libraries and launchers
        mod_lua.so         -- required by the mod_lua launcher
</pre>


</div> <!-- id="content" -->

</div> <!-- id="main" -->

<div id="about">
	<p><a href="http://validator.w3.org/check?uri=referer">Valid XHTML 1.0!</a></p>
	<p><small>$Id: install.windows.html,v 1.16 2007/11/21 19:34:06 carregal Exp $</small></p>
</div> <!-- id="about" -->

</div> <!-- id="container" -->

</body>
</html>









